MovieClip.getTextSnapshot()

Доступность

Среда разработки: Flash MX 2004.

Вопроизведение: SWF файлы, опубликованные для Flash Player 6 или более поздних, проигрываемые во Flash Player 7 или более поздних версиях.

Синтаксис

my_mc.getTextSnapshot() : TextSnapshot

Параметры

Нет.

Возвращает

Объект TextSnapshot, содержащий статический текст в мувиклипе my_mc.

Описание

Метод; возвращает объект TextSnapshot, содержащий текст во всех статических текстовых полях в указанном мувиклипе; текст в дочерних мувиклипах не включается. Этот метод всегда возвращает объект TextSnapshot.

Flash сцепляет строки текста и помещает их в объект TextSnapshot в порядке клавиатурного обхода статических текстовых полей мувиклипа. Текстовые поля, не имеющие номера в порядке клавиатурного обхода, помещаются в объект в случайном месте и имеют приоритет перед любыми текстовыми полями, которые имеют порядковый номер при клавиатурном обходе. Разделители вроде символа переноса строки или какое-либо форматирование, позволяющее определить, где кончается одна строка и начинается другая, отсутствует.

Замечание: Вы не можете задать порядок клавиатурного обхода для статических текстовых полей во Flash. Однако, некоторые другие продукты позволяют это сделать (например, Macromedia FlashPaper).

Содержимое объект TextSnapshot неизменно; иными словами, если мувиклип переходит на другой кадр, или как-либо еще изменяется (например, в нем добавляются или удаляются объекты), на содержимое объекта TextSnapshot эти изменения не влияют и он может неверно отражать содержимое мувиклипа. Чтобы быть уверенным в том, что содержимое объекта соответствует действительности, вызовите метод повторно, когда это необходимо.

Вы можете расширять методы и обработчики событий класса MovieClip, создавая его подклассы. Для более подробной информации смотри "Присвоение класса мувиклип-символу " в Использовании ActionScript во Flash.

Пример

В коде ниже динамически создается текстовое поле textShapshot_txt внутри мувиклипа text_mc и в нем отображается содержимое объекта TextSnapshot.

this.createEmptyMovieClip("text_mc", this.getNextHighestDepth());
text_mc.createTextField("textSnapshot_txt", text_mc.getNextHighestDepth(), 10, 10, 240, 160);
text_mc.textSnapshot_txt.multiline = true;
text_mc.textSnapshot_txt.wordWrap = true;
text_mc.textSnapshot_txt.autoSize = true;
text_mc.textSnapshot_txt.border = true;
text_mc.textSnapshot_txt.html = true;
//
var textSnap:TextSnapshot = text_mc.getTextSnapshot();
text_mc.textSnapshot_txt.htmlText = "<textformat tabstops='[150]'>";
for (var i in textSnap) {
  text_mc.textSnapshot_txt.htmlText += "<b>"+i+"</b>\t"+textSnap[i];
}
text_mc.textSnapshot_txt.htmlText += "</textformat>";

В текстовом поле text_mc.textSnapshot_txt отобразится следующий текст:

getTextRunInfo    [type Function]
setSelectColor    [type Function]
findText      [type Function]
hitTestTextNearPos  [type Function]
getSelectedText    [type Function]
getText        [type Function]
getSelected      [type Function]
setSelected      [type Function]
getCount      [type Function]

См. также

Объект TextSnapshot

Посмотреть комментарии LiveDocs

Предыдущая | Следующая | Оглавление